package com.ilink.groundservice.service.Practice;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.ilink.groundservice.entity.VO.AiX.AiXPracticeProjectResponse;
import com.ilink.ilinkapi.dto.ground.AiX.AiXPracticeProjectFilterRequest;
import com.ilink.ilinkapi.dto.ground.AiX.AiXPracticeProjectInsertRequest;
import com.ilink.ilinkapi.dto.ground.AiX.AiXPracticeProjectUpdateRequest;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

public interface AiXPracticeProjectService {

    /**
     * 分页查询实践项目列表
     */
    IPage<AiXPracticeProjectResponse> getPracticeProjectList(AiXPracticeProjectFilterRequest request);

    /**
     * 根据ID获取实践项目详情
     */
    AiXPracticeProjectResponse getPracticeProjectById(Long projectId);

    /**
     * 插入实践项目
     */
    Long insertPracticeProject(AiXPracticeProjectInsertRequest request);

    /**
     * 更新实践项目
     */
    void updatePracticeProject(AiXPracticeProjectUpdateRequest request);

    /**
     * 删除实践项目
     */
    void deletePracticeProject(Long projectId);

    /**
     * 更新实践项目封面
     */
    void updatePracticeProjectCover(MultipartFile file, Long projectId);

    /**
     * 获取热门实践项目
     */
    List<AiXPracticeProjectResponse> getPopularPracticeProjects(Integer limit);

    /**
     * 获取实训项目最常用的8个标签
     */
    List<String> getPracticeProjectTags(Long areaId);

    /**
     * 获取实训项目标签（替代分类）
     */
    List<String> getAllPracticeProjectTags(Long areaId);
} 